Intent

Introduces the NDO Prima Materia specification — the post-MVP design document for the Nondominium Object (NDO) three-layer model — and propagates it through all existing documentation and code. The NDO model solves a fundamental gap in the current architecture: ResourceSpecification and EconomicResource represent being, not becoming. There is no structure for a resource that is an idea, a design under review, or a project in active development. This PR lays the written foundation for that post-MVP evolution.

Also adds integration stubs for two optional external operators: Unyt (economic settlement via RAVE proofs and Smart Agreements) and Flowsta (cross-app identity via IsSamePersonEntry / DID vault), both gated behind the NDO capability slot surface.

Changes

New documents

• documentation/requirements/ndo_prima_materia.md (1 429 lines): the central NDO spec. Covers the three-layer model (NondominiumIdentity / ResourceSpecification+Assets / Process), lifecycle state machine (LifecycleStage vs OperationalState split), capability slot surface (§6), DHT data structures (§8), normative requirements REQ-NDO-L0 through REQ-NDO-AGENT-08 and REQ-NDO-CS-01 through REQ-NDO-CS-15, and migration path from the current architecture (§10).
• documentation/requirements/post-mvp/flowsta-integration.md (169 lines): Flowsta cross-app identity integration — architecture summary, three-phase integration path, requirements traceability.

Updated documentation

• documentation/requirements/requirements.md: adds §2.3 (post-MVP NDO/Unyt/Flowsta overview table) and §4.4 (Agent Ontology Requirements REQ-AGENT-01 through REQ-AGENT-15 with affiliation spectrum, composable profile, and identity portability).
• documentation/requirements/post-mvp/unyt-integration.md: minor alignment updates to cross-references and requirement IDs.
• documentation/archives/resources.md, agent.md, governance.md, implementation_plan.md, IMPLEMENTATION_STATUS.md: backfill of cross-references and gap analyses pointing to ndo_prima_materia.md.
• documentation/specifications/*: zome specs (person, resource, governance, architecture_overview) updated with NDO cross-links, known gaps, and future enhancement sections.
• documentation/ARCHITECTURE_COMPONENTS.md, DOCUMENTATION_INDEX.md: navigation and structure updates.

Code (TODO annotations only — no behavior change)

Four Rust files receive structured comment blocks cross-referencing the new documentation. No logic is altered:

• zome_person/src/role.rs: G13 — RolePromotionRequest DHT entry gap (queryable pending requests missing).
• zome_person/src/lib.rs (integrity): G1 — AgentEntityType field missing; G14 — closed RoleType enum, configurable role registry design.
• zome_resource/src/lib.rs (integrity): ResourceState conflation gap; PropertyRegime enum placeholder; ResourcesByState link split (REQ-NDO-OS-06).
• zome_gouvernance/src/lib.rs (integrity): Consume TODO updated to point at §5.3 lifecycle alignment.

Navigation pointers

• CLAUDE.md: documentation map section added for NDO and post-MVP integration files.
• README.md: documentation map link added.
• .github/pull_request_template.md: Related issues section formatting fix (bullet list).

Decisions

All changes in this PR are documentation and comment-only. No architectural decisions have been implemented. The design choices described in ndo_prima_materia.md (three-layer model, capability slot surface, LifecycleStage / OperationalState split, configurable role registry) are post-MVP proposals — they will each require their own implementation PR.

How to test

• bun run build:zomes — should compile without warnings or errors (Rust TODO comments are documentation only).
• Read documentation/requirements/ndo_prima_materia.md as the entry point; follow cross-references to verify navigability.
• Check documentation/DOCUMENTATION_INDEX.md for index coherence.

Documentation

This PR is the documentation update. All normative NDO requirements are introduced here and are the reference point for future implementation PRs.

Related

Related issues:

• Closes #[issue]

• Follow-up: future implementation PRs per ndo_prima_materia.md §10 migration phases